home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / WRIPDM16.ZIP / WINRIP.DOC < prev    next >
Text File  |  1993-10-19  |  50KB  |  1,158 lines
  1.                             WinRIP Lite - Version 1.0.
  2.                              Demonstration Software.
  3.         
  4.  
  5.                           Copyright (c) 1993  K. Waddon
  6.                                All rights reserved.
  7.  
  8.  
  9.  
  10.  
  11.         This version of WinRIP Lite is for DEMONSTRATION purposes only. 
  12.         WinRIP Lite is commercial software NOT shareware. The author does 
  13.         not guarentee that the demostration version of WinRIP Lite is 
  14.         complete nor that it is bug free.
  15.  
  16.         This software may be reproduced and distributed at will as long 
  17.         as no charge is made for providing copies of the software apart 
  18.         from the cost of materials, i.e. diskettes.
  19.  
  20.         This software may be made available for download from any 
  21.         bulletin board system as long as it is available in a directory 
  22.         for which no charge is made for access.
  23.  
  24.         For details on how to order WinRIP Lite, see the file 
  25.         "ORDER.FRM".
  26.  
  27.  
  28.  
  29.  
  30.  
  31.         There are no warranties with respect to this documentation. The 
  32.         information contained within this document is subject to change 
  33.         without notice. WinRIP Lite can be used and/or copied only in 
  34.         accordance with the terms specified. The Author and authorised 
  35.         dealers assumes no responsibilities for errors within the 
  36.         documentation. No part of this guide may be reproduced or 
  37.         transferred in any form or by any means with the written consent 
  38.         of The Author. 
  39.  
  40.         Trademarks. 
  41.         -----------
  42.  
  43.         IBM PC, IBM XT and IBM AT are registered trademarks of 
  44.         International Business Machines Corporation. 
  45.  
  46.         
  47.         
  48.         
  49.         
  50.         INTRODUCTION 
  51.  
  52.         What Do You Need to Use WinRIP Lite? 
  53.  
  54.         In order to use WinRIP Lite, there are certain hardware and 
  55.         software requirements. 
  56.  
  57.         Hardware Requirements 
  58.  
  59.         The following system requirements are applicable when using 
  60.         WinRIP Lite: 
  61.  
  62.                 IBM PC/XT/AT or comatible computer. 
  63.  
  64.                 Colour Graphic Display (VGA), with appropriate video card. 
  65.  
  66.  
  67.  
  68.         Software Requirements 
  69.  
  70.                 Microsoft Windows 3.1 
  71.  
  72.  
  73.  
  74.         About This Manual 
  75.  
  76.         This manual is meant to be a guide to using WinRIP Lite. It will 
  77.         not explain all the features of Microsoft Windows. For 
  78.         information concerning Windows you may need to refer to the 
  79.         documentation supplied by Microsoft with your copy of Windows 
  80.         3.1. 
  81.  
  82.  
  83.  
  84.         Windows Annomalies.
  85.         -------------------
  86.  
  87.         The is one feature of provided by the RIPscrip Specification that 
  88.         is not available in WinRIP. This is user defined line styles. 
  89.         Windows does not provide a method of defining line styles apart 
  90.         from those provided as standard within Windows. The 'standard' 
  91.         line styles available with RIPaint ARE available with WinRIP.
  92.  
  93.         Flood Fill Problems.
  94.          
  95.         Some RIP images create with editors other than WinRIP can cause 
  96.         problems with flood fill. This is caused by the line termination 
  97.         method used by windows.
  98.  
  99.         Windows 'rounds' the end of a line, whereas RIPaint and other 
  100.         editors tend to 'chop' the line. Therefore some images may not 
  101.         flood fill correctly if they were not created using WinRIP.
  102.  
  103.         THIS IS ONLY A PROBLEM WITH LINES THAT ARE 3 PIXELS THICK.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.         INSTALLATION.
  111.         
  112.         Before you make use of the WinRIP Lite Demonstration Software, 
  113.         you must first install it on your system.
  114.  
  115.         First, you should create a directory on your hard disk into 
  116.         which the contents of WRIPDEMO.ZIP should be unpacked. We suggest 
  117.         for simplicities sake that you call this directory WINRIP. There
  118.         is a sample BATCH file to automate the installation if you prefer
  119.         (INSTALL.BAT)
  120.  
  121.         You must now create several sub-directories in the WINRIP 
  122.         directory, these are:
  123.  
  124.                                 WINRIP\RIP
  125.                                 WINRIP\ICONS
  126.                                 WINRIP\BUTTONS
  127.                                 WINRIP\PATTERNS
  128.  
  129.         These are the default directories where WinRIP will expect to 
  130.         find RIP Image, RIP Icons, Button Styles and Fill Patterns 
  131.         respectively.
  132.  
  133.         Present in the WINRIP directory you will find three Windows 
  134.         TrueType Font Files, these are:
  135.  
  136.                                 SANS.TTF
  137.                                 GOTHIC.TTF
  138.                                 TRIPLEX.TTF
  139.  
  140.         You will need to install these fonts into Windows. To do this you 
  141.         will need to use the 'Control Panel' utility (Normally found in 
  142.         the 'Main' window of the Windows Desktop. Select Fonts from the 
  143.         Control Panel and use the 'ADD' option to select and install the 
  144.         three fonts.
  145.  
  146.         Thats all that is necessary to install the Demonstration Version 
  147.         of WinRIP Lite.
  148.  
  149.         The commercial version of WinRIP Lite has an installation utility 
  150.         that will install WinRIP for you.
  151.  
  152.  
  153.         The Editing Window.
  154.         -------------------
  155.  
  156.         Before you can perform any drawing with WinRIP Lite, you need to 
  157.         have an editing window open. This can be accomplished in two 
  158.         ways, either create a new picture, in which case a blank editing 
  159.         window is opened , or load an existing picture for editing. To 
  160.         create a new RIP image select the "New Picture" option from the 
  161.         pop-up File menu. To load an existing picture, select the "Load 
  162.         Picture" option from the pop-up File menu. 
  163.  
  164.         When loading an existing RIP picture, a dialog box will be opened 
  165.         containing directory list and file list boxes. This will enable 
  166.         you to select the picture file that is to be loaded. 
  167.  
  168.         In both cases an editing window is created which will measure 640 
  169.         x 350 pixels and will be given a black background. Once the 
  170.         editing window has been created the Toolbox Window will become 
  171.         active, as will the greyed items on the pull down menus. You will 
  172.         notice however that the "Load Picture" and "New Picture" options 
  173.         on the File menu are now greyed. This is because you can only 
  174.         have one RIP image open at any one time. 
  175.  
  176.  
  177.         The Main Menu Bar.
  178.         ------------------
  179.  
  180.         The Main Menu Bar along the top of the main window, contains 
  181.         several options, each of which will be explained in this section. 
  182.  
  183.         The Edit Menu.
  184.         --------------
  185.  
  186.         There are two entries on this menu, the UNDO facility erases the 
  187.         last drawing action. Once an action is "undone" it cannot be 
  188.         reinstated. The "Redraw Image" option simply clears the edit 
  189.         window and redraws the stored picture. This is useful if you want 
  190.         to see how the picture will be drawn at the remote terminal. 
  191.  
  192.         
  193.         The Icon Menu. 
  194.         --------------
  195.  
  196.         This menu, like the Edit Menu, only has two entries. The "Icon 
  197.         Editor" option loads the Icon Editor Utility so that you can 
  198.         create new icons and edit existing ones. 
  199.  
  200.         The "Load Icon" option allows you to load an icon for pasting 
  201.         onto your picture. When this option is selected a File Open 
  202.         dialog Box will be displayed containing Files List, Directory 
  203.         List and File Type boxes. The file type box displayed beneath the 
  204.         file list box has two files types specified, *.ICN and *.ICO. The 
  205.         .ICN file type is an icon stored in RIP format, the .ICO file 
  206.         type refers to Windows Icon format. WinRIP Lite is capable of 
  207.         importing and converting Windows Icons. 
  208.  
  209.         If you decide to load a Windows Icon, a message box will be 
  210.         displayed asking you if you wish to save the Icon in RIP format. 
  211.         If you respond by clicking the "Yes" button you will be presented 
  212.         with a File Dialog Box so you can specify which directory and 
  213.         file name is to be used to save the icon. 
  214.  
  215.         A rectangle, the exact size of the icon, will be displayed near 
  216.         the top right hand corner of the edit window. This rectangle may 
  217.         be moved to the position where the icon is to be pasted by moving 
  218.         the mouse pointer (which is changed to a hand in drag mode) into 
  219.         the rectangle, holding down the left hand mouse button and 
  220.         dragging the rectangle to the required position. Once the icon is 
  221.         in the desired position you can paste it onto your picture by 
  222.         clicking the right hand mouse button. 
  223.  
  224.         
  225.         The Fill Menu. 
  226.         --------------
  227.  
  228.         The Fill menu contains five entries all relating to the Fill 
  229.         Colour, Fill Pattern and Fill Boarder Colours. 
  230.  
  231.         Fill Toggle On/Off.
  232.         ------------------- 
  233.  
  234.         This option is a checked item, this means that selecting it does 
  235.         nothing more than placing a 'tick' against it. However, what 
  236.         selecting this actually does is to cause solid shapes, i.e. 
  237.         circles, rectangles, polygons etc to be automatically filled with 
  238.         the current fill colour and pattern. 
  239.  
  240.         Fill Border Colour.
  241.         -------------------
  242.  
  243.         Selecting this option from the Fill menu causes a window to be 
  244.         displayed showing the 16 colours in the currently active palette. 
  245.         From these colours you may select one to be the current Fill 
  246.         Border. This is used by the Flood Fill Tool when flood filling an 
  247.         area of the image. The flood fill will stop at the border colour. 
  248.         Clicking "Cancel" leave the border colour selection unchanged. 
  249.  
  250.  
  251.  
  252.         Fill  Pattern & Colour. 
  253.         -----------------------
  254.  
  255.         Selecting this option from the Fill menu causes a window to be 
  256.         opened containing two sets of controls. The large set of buttons 
  257.         represent the 12 standard fill patterns that may be selected. The 
  258.         colours arranged as two rows of eight are the 16 colours of the 
  259.         currently active palette. To select a Fill Pattern simply click 
  260.         on the desired pattern. You will notice that the large rectangle 
  261.         opposite the OK and CANCEL buttons will be filled with the 
  262.         selected pattern. To select the Fill Colour simply click on the 
  263.         desired colour. Clicking on the CANCEL button will restore the 
  264.         Fill Pattern and Colour to their previous state. 
  265.  
  266.  
  267.  
  268.         Fill Pattern Editor.
  269.         --------------------
  270.  
  271.         This option calls up the Pattern Editor, which allow you to 
  272.         create your own customised fill patterns. The Pattern Editor has 
  273.         two rectangular areas displayed side by side. The left hand 
  274.         rectangle represents an 8 x 8 pixel area in which the pixel are 
  275.         greatly enlarged. The right hand rectangle is used to display the 
  276.         effects of your editing, i.e. the rectangle will be filled with 
  277.         the pattern that you create so that you can see the effects your 
  278.         fill pattern will produce. 
  279.  
  280.         Button/Mouse. 
  281.         -------------
  282.  
  283.         This menu contains one entry, Button Designer. This is dealt with 
  284.         later in a separate section so won't be gone into here. 
  285.  
  286.         Options Menu. 
  287.         -------------
  288.  
  289.         This menu, with the exception of the Object Lister, contain 
  290.         options concerned with the drawing tools. 
  291.  
  292.         Write Mode Option.
  293.         ------------------
  294.  
  295.         This calls up another pop-up menu which has two items on it, 
  296.         "Normal" and "XOR". These two drawing modes effect how objects 
  297.         are drawn on the screen. In "Normal Mode" objects are draw in the 
  298.         currently selected draw colour. In "XOR Mode" the object is drawn 
  299.         on the screen by XORing the current draw colour with the colour 
  300.         already on the screen. A "tick" will be displayed against the 
  301.         currently active mode.
  302.  
  303.  
  304.         Line Thickness Option.
  305.         ----------------------
  306.  
  307.         This allows you to select the width of lines drawn on the screen, 
  308.         this also includes the thickness of boundaries of circles, 
  309.         polygons etc. Two options are available, line thickness of 1 
  310.         pixel and line thickness of 3 pixels. 
  311.  
  312.         Bezier Curve Smoothness Option.
  313.         -------------------------------
  314.  
  315.         A Bezier Curve is made up of several straight lines, obviously 
  316.         the smoothness of the curve is determined by the number of 
  317.         straight line segments that make up the curve. This option allows 
  318.         you to specify the number of segments that should be present in 
  319.         any Bezier Curve that you draw. The default is ten line segments, 
  320.         that is, each Bezier Curve will be made up of ten straight lines. 
  321.         The higher the value specified here the smoother the curve will 
  322.         appear on the screen. 
  323.  
  324.         Note, Bezier Curves are calculated using floating point 
  325.         arithmetic, the greater the number of segments in the curve the 
  326.         slower the processing will be. 
  327.  
  328.         Object List Option.
  329.         -------------------
  330.  
  331.         Not Active.
  332.  
  333.  
  334.         Font Menu. 
  335.         ----------
  336.  
  337.         The Font Menu allows you to select a Font Typeface and font Size. 
  338.  
  339.         Font Style Option.
  340.         ------------------
  341.         
  342.         This causes another pop-up menu to be displayed listing the 
  343.         available Font Styles. Select the style of font you require from 
  344.         this list. The currently selected font will have a "tick" 
  345.         displayed next to it. 
  346.  
  347.         Font Size Options.
  348.         ------------------
  349.  
  350.         These options allow you to select the size of the current font. 
  351.         Entries consist of a series of magnification factors, 1x, 2x ... 
  352.         10x. Select the font size you require. A "tick" will be displayed 
  353.         next to the current font size. 
  354.  
  355.         Applicable Drawing Controls.
  356.         ----------------------------
  357.  
  358.         In the next section the drawing tools are discussed in detail. 
  359.         With each drawing tool there is listed the "Applicable Drawing 
  360.         Controls". These mean that these options are used with that 
  361.         particular drawing tool and effect the display. These controls 
  362.         are: 
  363.  
  364.                        The Current Drawing Colour. 
  365.                        The Current Line Pattern. 
  366.                        The Current Line Thickness. 
  367.                        The Current Fill Colour. 
  368.                        The Current Fill Pattern. 
  369.                        The Write Mode. 
  370.                        The Font Size. 
  371.  
  372.         
  373.  
  374.         The Toolbox.
  375.         ------------
  376.         
  377.         The Toolbox contains all the drawing tools  needed to create a 
  378.         "RIP" image. Note that the toolbox is inactive while there is no 
  379.         editing window open. 
  380.  
  381.         The tools, listed from left to right, top to bottom are: 
  382.  
  383.  
  384.                           Pie Slice 
  385.                           Line Draw 
  386.                           Set Pixel 
  387.                           Hollow Rectangle 
  388.                           Filled Rectangle 
  389.                           Hollow Circle 
  390.                           Filled Ellipse 
  391.                           Circular Arc 
  392.                           Elliptical Arc 
  393.                           Hollow Polygon 
  394.                           Bezier Curve 
  395.                           Mouse Region 
  396.                           Flood Fill 
  397.                           Text Input 
  398.                           Filled Rectangle 
  399.                           Create Button 
  400.  
  401.         
  402.         The block of 16 colours at the bottom of the Toolbox show the 16 
  403.         currently active drawing colours,  i.e. the current active colour 
  404.         palette. The currently active drawing colour may be changed by 
  405.         clicking on one of these colours. Each of the drawing tools 
  406.         available in the Toolbox will now be discussed in detail. 
  407.  
  408.         
  409.         Pie Slice. 
  410.         ----------
  411.  
  412.         This tool allows you to draw a pie slice,  it will be filled with 
  413.         the current fill colour and pattern. To draw the pie slice move 
  414.         the mouse pointer to the point where you require the center of 
  415.         the arc to be. Hold down the left hand mouse button and without 
  416.         releasing the left hand mouse button, move the mouse pointer to 
  417.         position where the arc is to start, then release the left hand 
  418.         mouse button.  As you move the mouse pointer out from the center 
  419.         a line will be 'rubber banded' to follow the mouse pointer, 
  420.         giving an indication of the boundary of the arc. This line will 
  421.         form the radius of the arc. Next, hold down the left hand mouse 
  422.         button again and move the mouse pointer to the position at which 
  423.         the arc is to end and release the left hand mouse button, WinRIP 
  424.         Lite will then erase the 'rubber banding' lines and draw the pie 
  425.         slice. 
  426.  
  427.  
  428.  
  429.         Applicable Drawing Controls:
  430.         Draw Colour, Line Thickness, Fill Colour, Fill Pattern.
  431.  
  432.  
  433.  
  434.         Draw a Straight Line. 
  435.         ---------------------
  436.  
  437.         This tool allows you to draw a straight line, in the current 
  438.         drawing colour and line thickness. To draw a line move the mouse 
  439.         pointer to the position at which the line is to start and click 
  440.         the left hand mouse button. Move the mouse pointer to the 
  441.         position at which the line is to end. A 'rubber banding' line 
  442.         will be drawn from the line start position to the mouse pointer 
  443.         as it is moved. When the mouse pointer is at the point at which 
  444.         you want to end the line, click the left hand mouse button. 
  445.         WinRIP Lite will then draw a permanent line from the start point 
  446.         to the end point. 
  447.  
  448.         Applicable Drawing Controls:
  449.         Draw Colour, Line Pattern, Line Thickness, Write Mode. 
  450.  
  451.         
  452.         Set Individual Pixel. 
  453.         ---------------------
  454.  
  455.         This tool sets an individual pixel to the current drawing colour. 
  456.         Move the mouse point to the position of the pixel you wish to set 
  457.         and click the left hand mouse button. 
  458.  
  459.         Applicable Drawing Controls:
  460.         Draw Colour 
  461.  
  462.  
  463.  
  464.         Rectangle.
  465.         ----------
  466.  
  467.         This tool will allow you to draw a rectangle in the current 
  468.         drawing colour and line style. Move the mouse pointer to the top 
  469.         left hand corner position where you want the rectangle to start 
  470.         and click the left hand mouse button. Now move the mouse pointer 
  471.         to the position where you require the bottom right hand corner of 
  472.         the rectangle. A rectangle will be 'rubber banded' whilst you are 
  473.         moving mouse pointer. When the mouse pointer is positioned 
  474.         correctly click the right hand mouse button and WinRIP Lite will 
  475.         erase the 'rubber banded' rectangle and redraw it permanently. 
  476.  
  477.         Applicable Drawing Controls:
  478.         Draw Colour, Line Pattern, Write Mode. 
  479.  
  480.         
  481.         Filled Rectangle. 
  482.         -----------------
  483.  
  484.         This tool draws a rectangle that is filled with the current fill 
  485.         colour and pattern. You define the rectangle in exactly the same 
  486.         way as for the RECTANGLE tool described above. Note the rectangle 
  487.         will not be drawn with a border. 
  488.  
  489.         Applicable Drawing Controls:
  490.         Fill Colour, Fill Pattern.
  491.  
  492.         
  493.         Circle.
  494.         -------
  495.  
  496.         This tool draws a circle in the current draw colour and line 
  497.         thickness. Move the mouse pointer to the point which is to be the 
  498.         center of the circle and click the left and mouse button. Move 
  499.         the cursor away from the center point and a circle will be 
  500.         'rubber banded' as you move the mouse. When the circle is the 
  501.         correct size, click the left hand mouse button to fix the circle. 
  502.  
  503.         Applicable Drawing Controls:
  504.         Draw Colour, Line Thickness.
  505.  
  506.  
  507.         Filled Ellipse. 
  508.         ---------------
  509.  
  510.         This tool draws a complete ellipse in the current drawing colour 
  511.         and fills the interior with the current fill colour and  pattern. 
  512.         The method for drawing the ellipse is the same as for the circle 
  513.         above. 
  514.  
  515.         Applicable Drawing Controls:
  516.         Draw Colour, Line Thickness, Fill Colour, Fill Pattern. 
  517.  
  518.         
  519.         Circular Arc. 
  520.         -------------
  521.  
  522.         This tool draws a circular arc in the current drawing colour and 
  523.         line thickness. To draw the arc, move the mouse pointer to the 
  524.         position which is to be the center of the arc. Hold down the left 
  525.         mouse button and move the mouse pointer to the position where you 
  526.         wish the arc to start and release mouse button. Hold down the 
  527.         left mouse button and move the mouse pointer to the position at 
  528.         which the arc is to end. Release the mouse button. The arc will 
  529.         now be drawn. 
  530.  
  531.         Applicable Drawing Controls:
  532.         Draw Colour, Line Thickness.
  533.  
  534.         
  535.         Elliptical Arc. 
  536.         ---------------
  537.         
  538.         This tool draws an elliptical arc in the current drawing colour 
  539.         and line thickness. The arc is drawn within a rectangular 
  540.         'bounding box' which would contain the entire ellipse (if one 
  541.         were being drawn). The first step in drawing the arc is to define 
  542.         the bounding box, to do this move the mouse pointer to the 
  543.         position at which the top left hand corner is to be positioned. 
  544.         Click the left hand mouse button. Next move the mouse pointer to 
  545.         the position at which the bottom right hand corner of the 
  546.         bounding box is to be positioned and click the left hand mouse 
  547.         button. The 'rubber banded' bounding box will now be erased, and 
  548.         a line will be drawn from the center point of the imaginary 
  549.         ellipse to the mouse pointer. This line may be moved and defines 
  550.         the point at which the arc will start. Hold down the left hand 
  551.         mouse button and position the mouse pointer at the point at which 
  552.         the arc is to end. Release the mouse button and the arc will be 
  553.         drawn. 
  554.  
  555.         Applicable Drawing Controls:
  556.         Drawing Colour, Line Thickness.
  557.  
  558.  
  559.  
  560.         Polygon. 
  561.         --------
  562.  
  563.         This tool will draw a multi-sided closed polygon in the current 
  564.         drawing colour, line thickness and line pattern. Move the mouse 
  565.         pointer to the position where the polygon is to start and click 
  566.         the left hand mouse button.  Repeat this procedure for each point 
  567.         in the polygon. As  you move the mouse pointer the polygon will 
  568.         be drawn in and 'rubber banding' lines will be used to connect 
  569.         the mouse pointer to the last and first  points defined. To 
  570.         terminate the polygon click the right hand mouse button. 
  571.  
  572.  
  573.  
  574.         Applicable Drawing Controls:
  575.         Drawing Colour, Line Thickness, Line Pattern.
  576.  
  577.         
  578.         Bezier Curve.
  579.         -------------
  580.  
  581.         This tool allows you to draw customisable curves. Four control 
  582.         points are used to create the path that the curve follows. Two of 
  583.         these control points define the start and end points of the curve 
  584.         and the curve will actually touch these two points. The remaining 
  585.         two point are control points which 'pull' the curve away from the 
  586.         straight line defined by the start and end points. These two 
  587.         control points need not be actually on the curve. 
  588.  
  589.         To draw a curve, move the mouse pointer to the position at which 
  590.         the curve is to start and click the left hand mouse button. A 
  591.         small square point will be drawn. In actual fact this represents 
  592.         all four control points of the curve, one on top of the other. 
  593.         The order in which WinRIP Lite considers these points to be 
  594.         stacked, from top to bottom is the end point, 2nd control point, 
  595.         1st control point, start point. 
  596.  
  597.         To define the end point of the curve, move the mouse pointer over 
  598.         the square control marker, hold down the left hand mouse button 
  599.         and drag the control point to the position at which the curve is 
  600.         to end. Release the mouse pointer. A 'rubber banding' line will 
  601.         be drawn from the start point to the end point, and the curve 
  602.         will also be drawn, which should resemble a straight line. The 
  603.         square control marker at the start point will have been erased. 
  604.  
  605.         To move the 2nd control point, move the move pointer to the start 
  606.         position of the curve (easily found because of the 'rubber 
  607.         banding' line and hold down the left hand mouse pointer. The 
  608.         square control marker will be re drawn and it may be dragged to 
  609.         the position you require. Release the mouse button. You will now 
  610.         notice that the curve has changed shape. Repeat this procedure to 
  611.         position the 1st control point. 
  612.  
  613.         Once you have separated the four control markers you may adjust 
  614.         their relative positions by positioning the mouse pointer on a 
  615.         control point and dragging it to the desired position. 
  616.  
  617.         When you are happy with the shape of the curve, click the right 
  618.         hand mouse button to erase the control markers, the rubber 
  619.         banding lines and to make the curve permanent. 
  620.  
  621.         The 'smoothness' of the curve, which is made up of n segments of 
  622.         straight lines may be set from the by pulling down the Options 
  623.         menu from the menu bar. 
  624.  
  625.         Applicable Drawing Controls:
  626.         Draw Colour, Line Pattern, Line Thickness, Write Mode.
  627.  
  628.  
  629.         Mouse Region.
  630.         -------------
  631.  
  632.         This tool allows you to define a  rectangular area on the screen 
  633.         that functions as a "HOT" mouse region. If the user clicks the 
  634.         left mouse button while the mouse pointer is within the mouse 
  635.         region then terminal will transmit a predefined text string to 
  636.         the host. The rectangle is drawn using the same procedure for 
  637.         drawing a Rectangle (defined above). When the drawing of the 
  638.         rectangle is complete a dialog box ( shown below) is displayed so 
  639.         that you may enter the text that is to be sent to the host when 
  640.         this region is clicked. 
  641.  
  642.         The text entered into the dialog box above may contain control 
  643.         characters where each control character is represented by an 
  644.         ASCII character preceded by a ^ character, i.e. a 'RETURN' 
  645.         character may be entered as ^M. 
  646.  
  647.         The two other fields in the dialog box are checkboxes and if 
  648.         checked will have the following actions if they are checked: 
  649.  
  650.             
  651.             Invert the image when this region is clicked. 
  652.             
  653.             Indicates that the region should be visibly inverted while 
  654.             the mouse button is down, offering the user visual feedback 
  655.             that the region has been clicked. 
  656.  
  657.  
  658.  
  659.             Reset all windows and clear the screen after this region is 
  660.             clicked. 
  661.  
  662.             This will physically zoom the text window to full screen size 
  663.             and clear the screen. This is useful if the text instructs 
  664.             the host to enter an area that does not support RIP Graphics. 
  665.  
  666.  
  667.         Flood Fill.
  668.         -----------
  669.  
  670.         This tool is used to flood fill a region with a specific colour 
  671.         and pattern. Move the mouse pointer to a point within the area to 
  672.         be flood filled and click the left hand mouse button. The area 
  673.         will will be upto the border colour, at which point the operation 
  674.         terminates. Fill colour, pattern and border colour are selected 
  675.         by pulling down the Fill menu on the menu bar. 
  676.  
  677.         Applicable Drawing Controls:
  678.         Fill Colour, Fill Pattern.
  679.  
  680.         
  681.         Text Entry.
  682.         -----------
  683.  
  684.         This tool allows you to enter text into your RIP image in the 
  685.         current draw colour and font. Move the mouse pointer to the 
  686.         position where the text is to be placed and click the left hand 
  687.         mouse button. The dialog box shown below will be opened so that 
  688.         you can enter the required line of text. 
  689.  
  690.         The text entry area is larger than one line of text, this is for 
  691.         future developments to WinRIP Lite. You may only enter one line 
  692.         of text at present. 
  693.  
  694.         On clicking the OK button, the dialog box will clear and a 
  695.         bounding rectangle displayed, this bounding rectangle may be 
  696.         dragged to the required position and then the right hand mouse 
  697.         button clicked to paste the text. The text is output in the 
  698.         currently selected font and size. To change the font style and 
  699.         font size use the Font option on the menu bar. 
  700.  
  701.         Applicable Drawing Controls:
  702.         Draw Colour, Write Mode.
  703.  
  704.  
  705.         Filled Polygon. 
  706.         ---------------
  707.  
  708.         This tool is identical to the Polygon tool described above with 
  709.         the exception that the interior of the polygon is filled with the 
  710.         current fill colour and pattern. 
  711.         
  712.         Applicable Drawing Controls:
  713.         Draw Colour, Line Style, Line Thickness, Fill Colour, 
  714.         Fill Pattern, Write mode. 
  715.  
  716.         
  717.         Define a Button. 
  718.         ----------------
  719.  
  720.         This tool creates a new mouse button in the style currently 
  721.         defined in the Button Designer. As the operation of this tool is 
  722.         closely linked with the Button Designer you are strongly 
  723.         recommended to read the section entitled "The Button Designer" 
  724.         prior to using this tool. 
  725.  
  726.         To create the button move the mouse pointer to the upper left 
  727.         hand corner of where the button is to be positioned and click the 
  728.         left hand mouse button. Note that this may not be the actual top 
  729.         left hand corner of the button as any bevel, recess and sunken 
  730.         effects are not taken into account at this stage. The dialog box, 
  731.         shown below will be opened so that you can specify the Button 
  732.         Label, the text to be sent to the host etc, when the button is 
  733.         clicked. 
  734.  
  735.         The button label is the text that is displayed with the button, 
  736.         exactly how this label is positioned relative to the button 
  737.         itself is dependent on settings in the button style. 
  738.  
  739.         The 'Hot' Key defines a  key on the keyboard which if pressed has 
  740.         the same effect as if the button was clicked using the mouse. 
  741.  
  742.         The text to send to the host is simply the text that the terminal 
  743.         will send to the host system when the button is clicked. 
  744.  
  745.         The 'Draw button as already selected' if checked means that the 
  746.         button will be drawn as if it had been clicked. 
  747.  
  748.         The default if <<ENTER>> is pressed, if checked, means that if 
  749.         the user presses <<ENTER>> then the text associated with this 
  750.         button is sent to the host in response. 
  751.  
  752.         Once you have clicked on the dialog box's OK button and the 
  753.         dialog box cleared from the screen, the button can be drawn.  
  754.         This is carried out in one of two ways. For a button with a 
  755.         predefined width and height, a rectangle will be drawn on the 
  756.         screen representing the button surface. This rectangle may be 
  757.         dragged to the required position and the right hand mouse button 
  758.         clicked to paste the actual button. 
  759.  
  760.         If no width and height has been specified in button style, the 
  761.         button is sized by a 'rubber banding' rectangle. Once the 
  762.         rectangle is the correct size etc. click the left hand mouse 
  763.         button to create the button. 
  764.  
  765.  
  766.         Applicable Drawing Controls:
  767.         Font Sizes.
  768.  
  769.         The Button Designer.
  770.         --------------------
  771.  
  772.         Although The Button Designer comprises only of one window, it is 
  773.         complicated and significant enough to warrant a section all to 
  774.         itself! 
  775.  
  776.         The Button Designer does not do anything visibly on the screen, 
  777.         except display the window shown overleaf, but creates an internal 
  778.         template definition for a button, which is used in conjunction 
  779.         with the Button Drawing Tool to actually create buttons. 
  780.  
  781.         Button Types.
  782.         -------------
  783.  
  784.         There are only three main types of buttons, these are Plain, Icon 
  785.         and Clipboard Buttons. The "Button Type" is selected by clicking 
  786.         one of the Radio Buttons in the Button Type box at the top left 
  787.         hand corner of the Button Designer Window. You will notice that 
  788.         only one Button Type may be selected, this is because only one of 
  789.         Button Type may be in use at any one time. 
  790.  
  791.         Plain Buttons.
  792.         -------------- 
  793.  
  794.         A plain button is exactly what it says it is, "plain". A plain 
  795.         button does not use an icon in the image of the button. The 
  796.         button is constructed as a 'coloured' box, the colour of which 
  797.         corresponds to the SURFACE colour specified in the Button 
  798.         Designer window. (See below for details of the Surface colour. 
  799.  
  800.         Special effects may also use the "Special Effects" (described 
  801.         below) to enhance the image of the button. 
  802.  
  803.         Plain buttons may be of any size, or they can be of fixed size. 
  804.  
  805.  
  806.         Clipboard Buttons.
  807.         ------------------ 
  808.  
  809.         A Clipboard Button uses the current contents of the clipboard to 
  810.         provide the button image. This means you could use an image that 
  811.         you have previously loaded into the clipboard as a button, and 
  812.         keep reusing it. This method improves transmission efficiency by 
  813.         not having to keep on transmitting an icon file name etc. 
  814.  
  815.         Icon Buttons.
  816.         ------------- 
  817.  
  818.         An Icon Button uses a specified icon for it's image. When you 
  819.         create a button using the Button Tool, you will be expected to 
  820.         provide the icon file which is to be used as the button image. 
  821.         This will be the normal file open dialog box, you may use both 
  822.         RIP format Icons and Windows Icons as the button image. The icon 
  823.         specified will determine the actual size of the button and you 
  824.         may drag it to any position you desire. The rectangular mouse 
  825.         field drawn to represent the icon for 'dragging' purposes is 
  826.         exactly the size of the icon to aid you in accurate positioning. 
  827.  
  828.         Button Labels.
  829.         -------------- 
  830.  
  831.         Every button can have an optional text label which can appear in 
  832.         one of several different locations relative to the button itself. 
  833.         It's purpose is to inform the user of the function of the button. 
  834.         The actual text of the label is not specified in the Button 
  835.         Designer but when the button is actually created. However, the 
  836.         placement of the label is specified in the Button Designer window 
  837.         by clicking one of the radio buttons in the Label Orientation 
  838.         Group. This specifies where the label is to appear relative to 
  839.         the button and may be one of the following: 
  840.  
  841.              i)   Label text positioned above the button.
  842.             ii)   Label text positioned below the button.
  843.            iii)   Label text positioned to the right of the button.
  844.             iv)   Label text positioned to the left of the button.
  845.              v)   Label text positioned centrally within the button.
  846.  
  847.  
  848.         Label Colour (Foreground). 
  849.         --------------------------
  850.  
  851.         The colour of the label text may be selected by clicking on the 
  852.         Foreground button in the Button Designer Window. This will pop-up 
  853.         a Colour Dialog box from which you can choose on of 16 colours 
  854.         from the currently active palette. The colour chosen will also be 
  855.         used to colour the 'Foreground Button' in the Button Designer 
  856.         window, so that you can see immediately the current selected 
  857.         colour.
  858.         
  859.         DropShadow Effect. 
  860.         ------------------
  861.  
  862.         You may also specify that the Dropshadow special effect is to be 
  863.         used with the label. You do this by 'checking' the Dropshadow 
  864.         Checkbox in the Button Designer Window and by specifying the 
  865.         colour of the shadow by changing the colour of the 'Background' 
  866.         button.  This effect will first write the label text using the 
  867.         Background colour, but offset 1 pixel above and to the left of 
  868.         the 'normal' label position. Next the label text is displayed 
  869.         again, this time in the 'normal' position and using the 
  870.         Foreground colour. The overall effect of this option is to give 
  871.         the impression that the label is floating just above the screen 
  872.         and is casting a shadow. 
  873.  
  874.         Text Centering Adjustment. 
  875.         --------------------------
  876.  
  877.         Where the Label Orientation has been specified as either LEFT, 
  878.         RIGHT or CENTER, the label will be centered vertically relative 
  879.         to the button so that the text does look like it's "too low" or 
  880.         "too high". 
  881.  
  882.         In some situation though, in particular with large fonts you may 
  883.         notice that text centering is not quite right. This may be more 
  884.         evident with text with descenders. 
  885.  
  886.         Note, this situation cannot occur within WinRIP Lite as the 
  887.         descenders ARE taken into account when centering the text 
  888.         vertically, as is the Internal Leading. However, you must be 
  889.         aware that programs such as RIPaint and RIPterm DO NOT take into 
  890.         account the descenders when vertically centering text. 
  891.  
  892.         The Adj Text, should therefore be 'checked' where you are using 
  893.         text for the label that has descenders to ensure that the text is 
  894.         centered correctly in RIPterm. This option has no effect within 
  895.         WinRIP Lite. 
  896.  
  897.         
  898.         Hot Key Underlining. 
  899.         --------------------
  900.  
  901.         If you have specified that this button is a "Mouse Area", then 
  902.         you have the option of underlining the hotkey in the label text 
  903.         (if the hotkey character occurs in the label). This is used to 
  904.         indicate visually to the user, what the hotkey is. 
  905.  
  906.         If the "Underline" checkbox is "checked" in the Button Designer 
  907.         window, then the first occurrence of the hotkey character is 
  908.         underlined. If the Dropshadow effect is also active the underline 
  909.         will also be dropshadowed. 
  910.  
  911.         
  912.         Special Effects. 
  913.         ----------------
  914.  
  915.         The "Bright", "Dark" and "Surface" colours are used with plain 
  916.         button styles and with the special effects. These colours 
  917.         represent the hilighted colour, the shadowed colour and the 
  918.         normal surface colour that is used with the special effects. 
  919.         Typical combinations that might be specified are WHITE, DARK-GREY 
  920.         and LIGHT-GREY respectively to give a "3D chiselled-steel" 
  921.         effect. 
  922.  
  923.         
  924.         Bevelled Buttons. 
  925.         -----------------
  926.  
  927.         You can give any button a "Bevel", this gives the impression that 
  928.         the side of your button are slanted giving a 3D impression that 
  929.         the button is raised off of the screen. 
  930.  
  931.         The size of the bevel may be specified with the "Size" field in 
  932.         the Button Designer window. This is a numeric field which may 
  933.         contain a value between 0 - 99 inclusive. This number specifies 
  934.         the actual width of the bevel (in pixels). The default width of 
  935.         the bevel is 3 pixels. 
  936.  
  937.         Bevels use all three special effects colours (BRIGHT, DARK and 
  938.         SURFACE), the Surface colour is used on the corners to give the 
  939.         impression of an edge. 
  940.  
  941.         Note, the bevel is not implemented unless the "Bevel" checkbox 
  942.         has been 'checked'. Also if the bevel effect is turned on the the 
  943.         actual size of the button will be LARGER than the rectangular 
  944.         image you see on the screen. The bevel is added onto the button 
  945.         "image". This means that if you are creating an icon button, none 
  946.         of the actual icon will be overwritten by the bevel. 
  947.  
  948.         If a bevel button is a "Mouse Area", then the size of the mouse 
  949.         area is expanded to include the bevel. 
  950.  
  951.         
  952.         Recessed Buttons. 
  953.         -----------------
  954.  
  955.         To enable the recessed effect, the "Recess" checkbox in the 
  956.         Button Designer window must be 'checked' A recessed button has a 
  957.         3D effect that makes the button look as if it has been hewn out 
  958.         from the surrounding area. When clicked a recessed button will 
  959.         not invert/halite the recess. This is because the recess appears 
  960.         to be part of the surrounding area and not the button itself. 
  961.  
  962.         The recess effects adds two pixels to each side of the button, so 
  963.         the overall result is that the button will be four pixels wider 
  964.         and taller. Also the recess has no effect on the size of the 
  965.         mouse region for a mouse button. The recess effect makes use of 
  966.         all three special effects colours, plus BLACK. 
  967.  
  968.         
  969.         Sunken Buttons. 
  970.         ---------------
  971.  
  972.         To enable the sunken effect, the "Sunken" checkbox in the Button 
  973.         Designer window must be 'checked'. The overall effect is such 
  974.         that the interior of the button looks as if it has sunk a little 
  975.         from the edges of the button. The sunken effect does not affect 
  976.         the overall size of the button or mouse region in any way. The 
  977.         effect is drawn after any icon has been pasted onto the button 
  978.         and is drawn one pixel inside the actual button image. 
  979.  
  980.         Chiselled Buttons. 
  981.         ------------------
  982.  
  983.         The chisel effect also affect the actual image of the button and 
  984.         should primarily used with plain buttons. A chisel is a 
  985.         rectangular outline drawn several pixels inside the image of the 
  986.         button. A chisel is made up of two colours (BRIGHT and DARK) and 
  987.         is two pixels thick. 
  988.  
  989.         The chiselled effect, like sunken, draw on top of the actual 
  990.         button image. 
  991.  
  992.  
  993.         Mouse Buttons and Non-Mouse Buttons.
  994.         ------------------------------------ 
  995.  
  996.         Buttons may be created in two different modes. A mouse button is 
  997.         clickable and returns a text string to the host when it is 
  998.         clicked. A non-mouse button on the other hand has no host 
  999.         command, no hotkey, cannot be inverted when clicked, in fact it 
  1000.         can't even be clicked and does absolutely nothing other than 
  1001.         display itself on the screen. 
  1002.  
  1003.         
  1004.         Creating a Mouse Button. 
  1005.         ------------------------
  1006.  
  1007.         To define your button as a "Clickable Mouse Button" ensure that 
  1008.         the "Mouse Area" checkbox in the Button Designer window is 
  1009.         "checked".  When the "Mouse Area" is active more effects are 
  1010.         available to you. 
  1011.  
  1012.         
  1013.         Invert Button. 
  1014.         --------------
  1015.  
  1016.         The "Invert" field in the Button Designer window is used to 
  1017.         determine if the button is to be inverted when the user clicks on 
  1018.         it. If the "Invert" option is not "checked" then nothing visibly 
  1019.         will happen to the button when the user clicks it. Plain buttons 
  1020.         and clipboard buttons simply invert the image of the button when 
  1021.         they are clicked. 
  1022.  
  1023.         Icon buttons may also be inverted in the same manner, however 
  1024.         icon buttons also have another method of inverting. 
  1025.  
  1026.         
  1027.         Inverting an Icon Button. 
  1028.         -------------------------
  1029.  
  1030.         One aspect of icon buttons that sets it apart from other buttons 
  1031.         is the fact that you can specify an icon file for the image of 
  1032.         the button (in WinRIP Lite, this may be either a RIP format icon 
  1033.         or a Windows icon). If you enable the "Hot Icon " field in the 
  1034.         Button Designer window, you are effectively specifying a 
  1035.         different method of inverting the button. Instead of simply 
  1036.         inverting the button as described above, RIPterm will attempt to 
  1037.         load a new icon file and stamp it on the button. The file name of 
  1038.         this new icon will be the same as the button icon but use a file 
  1039.         name extension of .HIC. If a hot icon file does not exist the 
  1040.         button is inverted in the normal way. 
  1041.  
  1042.         Reset Screen after button is clicked.
  1043.         -------------------------------------
  1044.         
  1045.         This option is activated by "checking" the "Reset" field in the 
  1046.         Button Designer window. It is used to clear the screen and make 
  1047.         the text window full size. This is used where clicking the button 
  1048.         would cause the user to enter a non-graphical section of the BBS. 
  1049.         Therefore allowing the user to interact with the BBS in full 
  1050.         screen text mode. 
  1051.  
  1052.  
  1053.  
  1054.         Radio Buttons, Checkboxes and Button Groups. 
  1055.         --------------------------------------------
  1056.  
  1057.         Another feature of the Button Designer is to allow the grouping 
  1058.         of button into categories. These button groups act collectively 
  1059.         to create button like Radio Buttons or Checkboxes. 
  1060.  
  1061.         Button Groups.
  1062.         --------------
  1063.  
  1064.         A group of buttons is a collection of zero or more buttons that 
  1065.         are related to each other in some way. You may have a maximum of 
  1066.         36 groups. Each group may have as many buttons as you wish to a 
  1067.         maximum of 128. 
  1068.  
  1069.         When you create a button you assign it a group number. All 
  1070.         subsequent button that a re created are automatically place in 
  1071.         this group until you change the "Group No" in the Button Designer 
  1072.         window. 
  1073.  
  1074.         
  1075.         Radio Buttons.
  1076.         -------------- 
  1077.  
  1078.         A group of Radio Buttons are quite common in computer 
  1079.         application, especially in the Windows Environment. The "Plain", 
  1080.         "Clipboard" and "User Icon" button in the Button Designer window 
  1081.         for instance are Radio Buttons. The feature of Radio Buttons that 
  1082.         makes them so useful is that only one Radio Button in the group 
  1083.         may be active at any one time. So if you turn on a particular 
  1084.         Radio Button in a group, all the others will be turned off! A 
  1085.         Radio Button is defined by 'checking' the "Radio Group" checkbox 
  1086.         in the Button Designer Window. 
  1087.  
  1088.  
  1089.         CheckBoxes. 
  1090.         -----------
  1091.  
  1092.         Checkbox groups, unlike Radio Buttons, are groups where more than 
  1093.         one button may be active at any one time. An example of this is 
  1094.         the Button Designer window, where the special effect are 
  1095.         specified by 'checking' a checkbox. 
  1096.  
  1097.         A checkbox button is defined by "checking" the "checkbox" field 
  1098.         in the Button Designer window. 
  1099.  
  1100.         
  1101.         Creating Fixed Size Plain Buttons. 
  1102.         ----------------------------------
  1103.  
  1104.         There are two fields in the Button Designer captioned "Width" and 
  1105.         "Height", you can enter the actual size of the buttons to be 
  1106.         created (in pixels). This saves having to draw the button with 
  1107.         the Button Tool. 
  1108.  
  1109.         If you set these fields to ZERO, then when you create a button 
  1110.         with the Button Tool you will have to "click and drag" to 
  1111.         dynamically size the button. 
  1112.  
  1113.         
  1114.         Auto-Clipboard Buttons. 
  1115.         -----------------------
  1116.  
  1117.         An Auto-Clipboard that will take the image of the button and 
  1118.         automatically place it onto the Clipboard for use by later button 
  1119.         commands. This saves having to draw the button again and again. 
  1120.  
  1121.         To activate the Auto-Clipboard feature "check"  the "AutoClip" 
  1122.         checkbox in the Button Designer window. 
  1123.  
  1124.         Note, You should not use Auto-Clipboard feature if the "Hot Icon" 
  1125.         facility is active. 
  1126.  
  1127.         
  1128.         Saving and Loading Button Styles. 
  1129.         ---------------------------------
  1130.  
  1131.         You may save a button style to disk so that in future you may 
  1132.         reload them instead of having to recreate them. Simply click the 
  1133.         SAVE or LOAD button in the Button Designer window . This will 
  1134.         cause the File Open dialog box to be opened where you can select 
  1135.         the file to be save to, or the file to load. 
  1136.  
  1137.  
  1138.         Default Button Style. 
  1139.         ---------------------
  1140.  
  1141.         The default button discards the current button style and 
  1142.         reinstates the default button configuration. This default 
  1143.         configuration contains the following settings: 
  1144.  
  1145.                Button Type        =    Plain 
  1146.                Bevel              =    Active 
  1147.                Bevel Size         =    3 
  1148.                Background Colour  =    BLACK 
  1149.                Bright             =    WHITE  
  1150.                Dark               =    Dark Grey 
  1151.                Surface            =    Light Grey 
  1152.                Key                =    WHITE  
  1153.                Corners            =    Light Grey 
  1154.  
  1155.  
  1156.  
  1157.  
  1158.